<?php
/**
 * The MIT License
 *
 * Copyright (c) <year> <copyright holders>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 * Classe per eseguire il fetch dei risultati provenienti da uno Statement eseguito
 * in precedenza dalla classe BXDDb o BXDDbPrepare
 * 
 * @author Damiano Ciarla
 * @package lib
 * @subpackage db/result
 */
class BXDDbResult
{
	/**
	 * Statement della query
	 *
	 * @var PDOStatement
	 */
	private $sth;

	public function __construct(PDOStatement $sth)
	{
		$this->sth = $sth;
	}

	/**
	 * Recupera la prima riga da un set di risultati
	 *
	 * @param int $fetchStyle Tipologia di restituzione dati
	 * @param int $cursorOrientation Orientamento del cursore
	 * @param int $cursorOffset Offset
	 *
	 * @return array
	 */
	public function fetch($fetchStyle = null, $cursorOrientation = null, $cursorOffset = null)
	{
		if($fetchStyle !== null && $cursorOrientation !== null && $cursorOffset !== null)
		{
			return $this->sth->fetch($fetchStyle, $cursorOrientation, $cursorOffset);
		}
		elseif($fetchStyle !== null && $cursorOrientation !== null && $cursorOffset === null)
		{
			return $this->sth->fetch($fetchStyle, $cursorOrientation);
		}
		elseif($fetchStyle !== null && $cursorOrientation === null && $cursorOffset === null)
		{
			return $this->sth->fetch($fetchStyle);
		}
		else
		{
			return $this->sth->fetch();
		}
	}

	/**
	 * Recupera tutti i risultati restituiti dalla query
	 *
	 * @param int $fetchStyle Tipologia di restituzione dati
	 * @param int $fetchArgument Questo argomento ha un significato diverso a seconda del valore del parametro fetchStyle
	 * @param mixed $ctorArgs Argomenti del costruttore della classe quando il parametro è fetchStyle = DOP::FETCH_CLASS.
	 *
	 * @return array
	 */
	public function fetchAll($fetchStyle = null, $fetchArgument = null, $ctorArgs = null)
	{
		if($fetchStyle !== null && $fetchArgument !== null && $ctorArgs !== null)
		{
			return $this->sth->fetchAll($fetchStyle, $fetchArgument, $ctorArgs);
		}
		elseif($fetchStyle !== null && $fetchArgument !== null && $ctorArgs === null)
		{
			return $this->sth->fetchAll($fetchStyle, $fetchArgument);
		}
		elseif($fetchStyle !== null && $fetchArgument === null && $ctorArgs === null)
		{
			return $this->sth->fetchAll($fetchStyle);
		}
		else
		{
			return $this->sth->fetchAll();
		}
	}

	/**
	 * Restituisce una singola colonna dalla riga successiva di un set di risultati
	 *
	 * @param int $columnNumber numero della colonna che si desidera recuperare dalla riga. Se nessun valore è fornito si prende in considerazione la prima colonna.
	 *
	 * @return string
	 */
	public function fetchColumn($columnNumber = null)
	{
		if($columnNumber !== null)
		{
			return $this->sth->fetchColumn($columnNumber);
		}
		else
		{
			return $this->sth->fetchColumn();
		}
	}

	/**
	 * Recupera la riga successiva da un set di risultati e la restituisce come un oggetto.
	 *
	 * @param string $className Nome della classe
	 * @param mixed $ctorArgs Argomenti del costruttore della classe quando il parametro è fetchStyle = DOP::FETCH_CLASS.
	 * 
	 * @return mixed|stdClass Restituisce un'istanza della classe richiesta con nomi di proprietà che corrispondono ai nomi delle colonne
	 */
	public function fetchObject($className = null, $ctorArgs = null)
	{
		if($className !== null && $ctorArgs !== null)
		{
			return $this->sth->fetchObject($className, $ctorArgs);
		}
		elseif($className !== null && $ctorArgs === null)
		{
			return $this->sth->fetchObject($className);
		}
		else
		{
			return $this->sth->fetchObject();
		}
	}

	/**
	 * Restituisce il numero di righe interessate dalla ultima query eseguita
	 *
	 * @return int Numero delle righe trovate
	 */
	public function rowCount()
	{
		return $this->sth->rowCount();
	}

	/**
	 * Restituisce il numero di colonne nel set di risultati
	 *
	 * @return int Numero di colonne trovate
	 */
	public function columnCount()
	{
		return $this->sth->columnCount();
	}
}
?>
